Removes a region from a window’s update region.

OSStatus ValidWindowRgn (
    WindowRef window, 
     region
);

window

A pointer to the window containing the region that you wish to remove from being updated.

region

Set this region to specify, in local coordinates, the area to be removed from the window’s update region.

function result

A result code.

DISCUSSION

The ValidWindowRgn function informs the Window Manager that an area of a window no longer needs to be redrawn. The ValidWindowRgn function is similar to the ValidRgn function, but ValidWindowRgn allows the window that it operates upon to be explicitly specified, instead of operating on the current graphics port, so ValidWindowRgn does not require the graphics port to be set before its use.

See also the functions InvalWindowRgn and ValidWindowRect.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when WindowsLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by WindowsLib 8.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)